Autogenerated HTML docs for v2.2.0-rc0
diff --git a/howto/setup-git-server-over-http.html b/howto/setup-git-server-over-http.html index 884a8bc..b73393b 100644 --- a/howto/setup-git-server-over-http.html +++ b/howto/setup-git-server-over-http.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 8.6.6" /> +<meta name="generator" content="AsciiDoc 8.6.9" /> <title>How to setup Git server over http</title> <style type="text/css"> /* Shared CSS for AsciiDoc xhtml11 and html5 backends */ @@ -87,10 +87,16 @@ ul > li { color: #aaa; } ul > li > * { color: black; } -pre { +.monospaced, code, pre { + font-family: "Courier New", Courier, monospace; + font-size: inherit; + color: navy; padding: 0; margin: 0; } +pre { + white-space: pre-wrap; +} #author { color: #527bbd; @@ -219,7 +225,7 @@ } div.imageblock div.content { padding-left: 0; } -span.image img { border-style: none; } +span.image img { border-style: none; vertical-align: text-bottom; } a.image:visited { color: white; } dl { @@ -349,7 +355,7 @@ margin-bottom: 0.1em; } -div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { +div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { margin-top: 0; margin-bottom: 0; } @@ -407,18 +413,14 @@ span.overline { text-decoration: overline; } span.line-through { text-decoration: line-through; } +div.unbreakable { page-break-inside: avoid; } + /* * xhtml11 specific * * */ -tt { - font-family: monospace; - font-size: inherit; - color: navy; -} - div.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -452,12 +454,6 @@ * * */ -.monospaced { - font-family: monospace; - font-size: inherit; - color: navy; -} - table.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -537,6 +533,8 @@ @media print { body.manpage div#toc { display: none; } } + + </style> <script type="text/javascript"> /*<+'])'); + var re = new RegExp('[hH]([1-'+(toclevels+1)+'])'); // Function that scans the DOM tree for header elements (the DOM2 // nodeIterator API would be a better technique but not supported by all // browsers). @@ -610,7 +608,7 @@ var i; for (i = 0; i < toc.childNodes.length; i++) { var entry = toc.childNodes[i]; - if (entry.nodeName == 'div' + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") && entry.getAttribute("class").match(/^toclevel/)) tocEntriesToRemove.push(entry); @@ -656,7 +654,7 @@ var entriesToRemove = []; for (i = 0; i < noteholder.childNodes.length; i++) { var entry = noteholder.childNodes[i]; - if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote") + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote") entriesToRemove.push(entry); } for (i = 0; i < entriesToRemove.length; i++) { @@ -747,7 +745,7 @@ </td> <td class="content">This document is from 2006. A lot has happened since then, and this document is now relevant mainly if your web host is not CGI capable. -Almost everyone else should instead look at linkgit:git-http-backend[1].</td> +Almost everyone else should instead look at <a href="../git-http-backend.html">git-http-backend(1)</a>.</td> </tr></table> </div> <div class="paragraph"><p>Since Apache is one of those packages people like to compile @@ -763,10 +761,10 @@ </p> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian: +<pre><code>On Debian: $ apt-get install apache2 To get apache2 by default started, - edit /etc/default/apache2 and set NO_START=0</tt></pre> + edit /etc/default/apache2 and set NO_START=0</code></pre> </div></div> </li> <li> @@ -775,11 +773,11 @@ </p> <div class="literalblock"> <div class="content"> -<pre><tt>This could be found under /etc/httpd, or refer to your Apache documentation.</tt></pre> +<pre><code>This could be found under /etc/httpd, or refer to your Apache documentation.</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian: this means being able to edit files under /etc/apache2</tt></pre> +<pre><code>On Debian: this means being able to edit files under /etc/apache2</code></pre> </div></div> </li> <li> @@ -788,19 +786,19 @@ </p> <div class="literalblock"> <div class="content"> -<pre><tt>'apachectl --graceful' might do. If it doesn't, just stop and +<pre><code>'apachectl --graceful' might do. If it doesn't, just stop and restart apache. Be warning that active connections to your server -might be aborted by this.</tt></pre> +might be aborted by this.</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian: +<pre><code>On Debian: $ /etc/init.d/apache2 restart or $ /etc/init.d/apache2 force-reload (which seems to do the same) This adds symlinks from the /etc/apache2/mods-enabled to -/etc/apache2/mods-available.</tt></pre> +/etc/apache2/mods-available.</code></pre> </div></div> </li> <li> @@ -837,37 +835,37 @@ DocumentRoot /where/ever/httpd.conf" to find your root:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ cd /usr/local/apache/htdocs -$ mkdir my-new-repo.git</tt></pre> +<pre><code>$ cd /usr/local/apache/htdocs +$ mkdir my-new-repo.git</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian:</tt></pre> +<pre><code>On Debian:</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ cd /var/www -$ mkdir my-new-repo.git</tt></pre> +<pre><code>$ cd /var/www +$ mkdir my-new-repo.git</code></pre> </div></div> <div class="paragraph"><p>Initialize a bare repository</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ cd my-new-repo.git -$ git --bare init</tt></pre> +<pre><code>$ cd my-new-repo.git +$ git --bare init</code></pre> </div></div> -<div class="paragraph"><p>Change the ownership to your web-server’s credentials. Use <tt>"grep ^User -httpd.conf"</tt> and <tt>"grep ^Group httpd.conf"</tt> to find out:</p></div> +<div class="paragraph"><p>Change the ownership to your web-server’s credentials. Use <code>"grep ^User +httpd.conf"</code> and <code>"grep ^Group httpd.conf"</code> to find out:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ chown -R www.www .</tt></pre> +<pre><code>$ chown -R www.www .</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian:</tt></pre> +<pre><code>On Debian:</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ chown -R www-data.www-data .</tt></pre> +<pre><code>$ chown -R www-data.www-data .</code></pre> </div></div> <div class="paragraph"><p>If you do not know which user Apache runs as, you can alternatively do a "chmod -R a+w .", inspect the files which are created later on, and @@ -883,27 +881,27 @@ <div class="paragraph"><p>First make sure the dav_module is loaded. For this, insert in httpd.conf:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>LoadModule dav_module libexec/httpd/libdav.so -AddModule mod_dav.c</tt></pre> +<pre><code>LoadModule dav_module libexec/httpd/libdav.so +AddModule mod_dav.c</code></pre> </div></div> <div class="paragraph"><p>Also make sure that this line exists which is the file used for locking DAV operations:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>DAVLockDB "/usr/local/apache2/temp/DAV.lock"</tt></pre> +<pre><code>DAVLockDB "/usr/local/apache2/temp/DAV.lock"</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian these steps can be performed with:</tt></pre> +<pre><code>On Debian these steps can be performed with:</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>Enable the dav and dav_fs modules of apache: +<pre><code>Enable the dav and dav_fs modules of apache: $ a2enmod dav_fs (just to be sure. dav_fs might be unneeded, I don't know) $ a2enmod dav The DAV lock is located in /etc/apache2/mods-available/dav_fs.conf: - DAVLockDB /var/lock/apache2/DAVLock</tt></pre> + DAVLockDB /var/lock/apache2/DAVLock</code></pre> </div></div> <div class="paragraph"><p>Of course, it can point somewhere else, but the string is actually just a prefix in some Apache configurations, and therefore the <em>directory</em> has to @@ -911,32 +909,32 @@ <div class="paragraph"><p>Then, add something like this to your httpd.conf</p></div> <div class="literalblock"> <div class="content"> -<pre><tt><Location /my-new-repo.git> +<pre><code><Location /my-new-repo.git> DAV on AuthType Basic AuthName "Git" AuthUserFile /usr/local/apache2/conf/passwd.git Require valid-user -</Location></tt></pre> +</Location></code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian: - Create (or add to) /etc/apache2/conf.d/git.conf :</tt></pre> +<pre><code>On Debian: + Create (or add to) /etc/apache2/conf.d/git.conf :</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt><Location /my-new-repo.git> +<pre><code><Location /my-new-repo.git> DAV on AuthType Basic AuthName "Git" AuthUserFile /etc/apache2/passwd.git Require valid-user -</Location></tt></pre> +</Location></code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>Debian automatically reads all files under /etc/apache2/conf.d.</tt></pre> +<pre><code>Debian automatically reads all files under /etc/apache2/conf.d.</code></pre> </div></div> <div class="paragraph"><p>The password file can be somewhere else, but it has to be readable by Apache and preferably not readable by the world.</p></div> @@ -944,8 +942,8 @@ $ htpasswd -c /usr/local/apache2/conf/passwd.git <user></p></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian: - $ htpasswd -c /etc/apache2/passwd.git <user></tt></pre> +<pre><code>On Debian: + $ htpasswd -c /etc/apache2/passwd.git <user></code></pre> </div></div> <div class="paragraph"><p>You will be asked a password, and the file is created. Subsequent calls to htpasswd should omit the <em>-c</em> option, since you want to append to the @@ -957,16 +955,16 @@ <div class="paragraph"><p>On Debian:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>To test the WebDAV part, do:</tt></pre> +<pre><code>To test the WebDAV part, do:</code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ apt-get install litmus -$ litmus http://<servername>/my-new-repo.git <username> <password></tt></pre> +<pre><code>$ apt-get install litmus +$ litmus http://<servername>/my-new-repo.git <username> <password></code></pre> </div></div> <div class="literalblock"> <div class="content"> -<pre><tt>Most tests should pass.</tt></pre> +<pre><code>Most tests should pass.</code></pre> </div></div> <div class="paragraph"><p>A command-line tool to test WebDAV is cadaver. If you prefer GUIs, for example, konqueror can open WebDAV URLs as "webdav://…" or @@ -986,9 +984,9 @@ asked to input your password a <em>lot</em> of times):</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>machine <servername> +<pre><code>machine <servername> login <username> -password <password></tt></pre> +password <password></code></pre> </div></div> <div class="paragraph"><p>…and set permissions: chmod 600 ~/.netrc</p></div> @@ -997,7 +995,7 @@ <div class="paragraph"><p>To check whether all is OK, do:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>curl --netrc --location -v http://<username>@<servername>/my-new-repo.git/HEAD</tt></pre> +<pre><code>curl --netrc --location -v http://<username>@<servername>/my-new-repo.git/HEAD</code></pre> </div></div> <div class="paragraph"><p>…this should give something like <em>ref: refs/heads/master</em>, which is the content of the file HEAD on the server.</p></div> @@ -1005,8 +1003,8 @@ you want to export:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ git-config remote.upload.url \ - http://<username>@<servername>/my-new-repo.git/</tt></pre> +<pre><code>$ git-config remote.upload.url \ + http://<username>@<servername>/my-new-repo.git/</code></pre> </div></div> <div class="paragraph"><p>It is important to put the last <em>/</em>; Without it, the server will send a redirect which git-http-push does not (yet) understand, and git-http-push @@ -1019,7 +1017,7 @@ <div class="paragraph"><p>From your client repository, do</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>$ git push upload master</tt></pre> +<pre><code>$ git push upload master</code></pre> </div></div> <div class="paragraph"><p>This pushes branch <em>master</em> (which is assumed to be the branch you want to export) to repository called <em>upload</em>, which we previously @@ -1041,7 +1039,7 @@ <div class="paragraph"><p>If git-http-push says</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>Error: no DAV locking support on remote repo http://...</tt></pre> +<pre><code>Error: no DAV locking support on remote repo http://...</code></pre> </div></div> <div class="paragraph"><p>then it means the web-server did not accept your authentication. Make sure that the user name and password matches in httpd.conf, .netrc and the URL @@ -1055,7 +1053,7 @@ <div class="paragraph"><p>Reading /usr/local/apache2/logs/error_log is often helpful.</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>On Debian: Read /var/log/apache2/error.log instead.</tt></pre> +<pre><code>On Debian: Read /var/log/apache2/error.log instead.</code></pre> </div></div> <div class="paragraph"><p>If you access HTTPS locations, Git may fail verifying the SSL certificate (this is return code 60). Setting http.sslVerify=false can @@ -1071,7 +1069,7 @@ <div id="footnotes"><hr /></div> <div id="footer"> <div id="footer-text"> -Last updated 2014-08-17 11:15:01 PDT +Last updated 2014-10-31 13:22:29 PDT </div> </div> </body> 